home *** CD-ROM | disk | FTP | other *** search
/ Palm Utilities / Palm_Utilities_CD-ROM_2001_2001.iso / files / misc / Star Pilot Plus 2.80 / spp.exe / Star Pilot v2.30 / spdocs.txt < prev    next >
Encoding:
Text File  |  1998-10-13  |  12.4 KB  |  235 lines
  1. Introduction
  2. ------------
  3. Star Pilot documentation is provided online here instead of in the program
  4. itself because it is nearly impossible to cram the amount of 
  5. documentation information that we wish to provide into the program 
  6. itself. This documentation will take you through the main screens and 
  7. each of the menu options.
  8.  
  9. Initial Setup 
  10. ----------------
  11. The first time you run Star Pilot you will be prompted with a screen like 
  12. this. Star Pilot is asking you to enter your location. The three most 
  13. populated cities for each U.S. state as well as Washington D.C. are 
  14. preprogrammed and can be selected from the "City" drop down list. Select 
  15. the city closest to you or specify your exact latitude and longitude as 
  16. well as GMT offset. If you are currently in Daylight Savings Time, be 
  17. sure to check the "DST" box as this will automatically adjust your GMT 
  18. offset internally. 
  19.  
  20. Main Screen
  21. ----------------- 
  22. The next screen you will be presented with is the main screen which is 
  23. where you will spend the majority of your time in Star Pilot. You will 
  24. most likely see some dots of varying size on your screen and possibly a 
  25. few letters. The dots correspond to stars while the letters represent 
  26. planets, the sun or the moon. The circle represents the entire sky around 
  27. you. If you were to hold the Pilot over your head with the top of it 
  28. facing north and the screen facing down to the ground, the sky would 
  29. appear exactly as it does on the Pilot (this is how most star charts are 
  30. oriented). The compass in the top left is there to remind you of the 
  31. orientation of the screen. If you swap the east-west orientation in the 
  32. general preferences menu, the compass will reverse appropriately. The 
  33. icon on the bottom right, if clicked, will replot the stars. The toolbar 
  34. in the bottom left lets you chose modes. If the arrow is selected, when 
  35. you point to an area of the screen with your stylus, the altitude by 
  36. azimuth display in the top right will update only. If the magnifying 
  37. glass is selected, placing the stylus on the screen allows you to zoom on 
  38. a portion of the sky when you release the stylus. Finally, if the 
  39. cross-hair is selected, clicking with the stylus on the screen identifies 
  40. the nearest object in the sky to where you clicked. 
  41.  
  42. Zoom Screen
  43. ------------------ 
  44. If you select the magnifying glass on the main screen, then click on a 
  45. region of the screen a box appears indicating the area you are going to 
  46. zoom in on. When you release the stylus from the screen a zoom window 
  47. (as shown on the left) pops up. This is a magnified view of the area of 
  48. the sky you clicked on. Zoom factor and constellation lines are settable 
  49. through a preferences menu as will be shown later. When you are done 
  50. looking at this zoomed area, simply click the "Close" button. 
  51.  
  52. ID Screen
  53. -------------
  54. If you select the cross-hair on the main screen, then click on a point 
  55. of the sky and release, an ID box will appear with information about the 
  56. object in the sky closest to where you clicked. Name indicates the common 
  57. name of the star or planet (for stars this can often be greek letters), 
  58. the constellation indicates what constellation the star is a part of 
  59. (N/A for planets), the star type indicates what type of star this star is 
  60. (color, and binary), and the distance indicates the distance from the 
  61. Earth to the star or planet at the current time (light years for stars, 
  62. AU for planets).
  63.  
  64. Action Menu 
  65. ------------------
  66. Change Date & Time 
  67. From this screen you can change the date and time Star Pilot will display 
  68. a starmap for. If you check "Use Current Time", Star Pilot will use the 
  69. Pilot's internal date and time. Note that in the unregistered version you 
  70. may change the time, but the date must be the current internal Pilot date. 
  71.  
  72. Find 
  73. When you chose "find constellation" or "find star", a dialog will popup 
  74. that allows you to type the name of the constellation or star you wish to 
  75. find. After entering a name and clicking on "Ok" Star Pilot searches its 
  76. databases to see if the specified object is in its database. If it is not, 
  77. an error message is presented. If the object is in the database, but not 
  78. currently visible in the sky, a different message is presented. However, 
  79. if the object is in the database and visible in the sky, the object will 
  80. blink for five seconds as shown in the pictures to the left. Please note 
  81. that the find feature is only available in the registered version of the 
  82. program. If you wish to be able to use this feature, please consider 
  83. purchasing Star Pilot. 
  84.  
  85. Launch Sun!, Moon!, JMoons! 
  86. With these actions, if you have Sun!, Moon!, or JMoons! installed on your 
  87. Pilot, you can automatically launch them from Star Pilot. Star Pilot will 
  88. provide your location and time zone information to these programs and 
  89. then open them. Note that you must have the registered versions of Star 
  90. Pilot and the application you are launching in order to use this feature. 
  91.  
  92. Options Menu 
  93. --------------------
  94. General 
  95. The "general" options screen allows you to use the hardware buttons and 
  96. disable the Pilot's auto-off. If you chose to use the hardware buttons, 
  97. the datebook button becomes "find star", the address book button becomes 
  98. "find constellation", the todo list button becomes "cycle through 
  99. toolbar", and the memopad button becomes "redraw". If you select "disable 
  100. auto-off", the Pilot will not turn off automatically while in Star Pilot, 
  101. but it will resume doing so after you exit the program. The final option 
  102. in this menu allows you to reverse east and west on the main screen 
  103. display. By default, Star Pilot expects you to have east on the left 
  104. (holding the Pilot above your head), but if you prefer to look at it on 
  105. flat below you, select this option and Star Pilot will plot the star maps 
  106. in reversed east-west fashion. The default for all of these options is 
  107. off. 
  108.  
  109. Location 
  110. This menu selection brings up the initial setup screen that allows you to 
  111. set your location. If your location changes, just come to this screen and 
  112. reset your settings. 
  113.  
  114. Magnitudes
  115. This screen allows you to set the minimum and maximum magnitude stars to 
  116. view on the main screen. Remember that the smaller the number magnitude, 
  117. the brigther the star (hence a -1 magnitude star is much brighter than a 
  118. 3 magnitude star). The rural and city buttons give preprogrammed values 
  119. for what you might see in rural versus city locations, but some stars in 
  120. the database are even smaller in magnitude than the rural settings show. 
  121. The defaults for these options are Min: 3 Max: -3 
  122.  
  123. Objects  
  124. This screen allows you to turn specific databases on and off. If you wish 
  125. to only view planets, you would unclick main stars and click planets. If 
  126. didn't want to see any planets and only stars, you'd click main stars and 
  127. unclick planets. The "registered stars" refers to the registered database 
  128. and the "special events" refers to possible special databases that may be 
  129. released from time to time. "Erase" means to erase the stars before 
  130. redrawing. If you'd like to see star trails, unclick "erase". The 
  131. "redraw" setting is the number of minutes between automatic main screen 
  132. redrawings. The defaults for this screen is to have "Main Stars", 
  133. "Planets", and "Erase" checked, and redraw set for 10. 
  134.  
  135. Planets 
  136. From this screen you can select which planets you wish to view. In 
  137. addition you can specify what symbol each planet is displayed with 
  138. (letters and numbers only). By default, only Venus, Mars, Jupiter, and 
  139. Saturn are checked. 
  140.  
  141. Zoom 
  142. From here you can set the zoom options. The zoom factor affects the size 
  143. of the zoom box as well as the magnification at which the objects are 
  144. zoomed in on. Checking "constellation lines" will draw constellation lines 
  145. when you zoom in. The default zoom factor is 2 and constellation lines 
  146. are by default off. 
  147.  
  148. Help Menu
  149. ---------------
  150. Register 
  151. The registration screen allows you to enter your registration number that 
  152. you receive by purchasing Star Pilot. The "Name" field refers to your 
  153. Pilot username. Be sure this is the name you submit to PilotGear H.Q. when 
  154. buying Star Pilot. 
  155.  
  156. Technical Support FAQ
  157. --------------------------------
  158. Attention Mac and Pilot 1000/5000 Users!
  159. If you are having problems installing the database .pdb file, make sure 
  160. you have upgrade to version 1.01 of the Conduit Manager for free from 
  161. Palm Computing. If you use a version older than 1.01 of this program, 
  162. although you select the .pdb for install, it will not actually be 
  163. installed. 
  164.  
  165. Q. Does Star Pilot work with FlashBuilder - Can I load it to ROM? 
  166. A. No, but this will change. You should be able to put splib.prc in ROM 
  167. however, but this is untested.
  168.  
  169. Q. What versions of the PalmPilot is Star Pilot compatible with? 
  170. A. Star Pilot has only been phyisically tested on a PalmPilot Professional 
  171. with OS/2.03, an upgraded Pilot 1000 running OS/2.0, and a Palm III. We 
  172. have no way at present of testing the program with any OS version less 
  173. than 2.0, but there is no reason it should not work on an unupgraded Pilot 
  174. 1000 or 5000. In addition, we have no experience with the TRG memory 
  175. boards, but there should be no compatibility problems with any of these 
  176. products. If you have compatibility problems, please contact us. The most 
  177. problems have been reported on PalmPilot Personal editions, but Star Pilot
  178. has no problem with the majority of these units. However, in order to take 
  179. full advantage of Star Pilot Plus, a PalmPilot Personal or newer is 
  180. recommended.
  181.  
  182. Q. Star Pilot is somewhat slow, how can I make it faster? 
  183. A. Yes, Star Pilot is somewhat slow, but this is due to the nature of the 
  184. Pilot. Star Pilot must perform thousands of floating point operations in 
  185. order to plot the precise positions of all the stars and planets. The 
  186. Pilot does not have a dedicated floating point unit and therefore emulates 
  187. these instructions rather slowly. We have already taken many steps to 
  188. optimize the speed and will continue to do so in future versions. For now,
  189. the best way to increase the speed is to have Star Pilot display less 
  190. stars (change what magnitudes you wish to display) because Star Pilot does 
  191. not perform calculations on stars that are outside the desired magnitude 
  192. settings.
  193.  
  194. Q. Star Pilot crashes my Pilot. 
  195. A. This is certainly possible. Although we have done our best to prevent 
  196. any crashes, we cannot make any guarantees about your hardware setup. 
  197. Please contact us with your hardware configuration, what portions of 
  198. Star Pilot you have installed (ie. what databases), what you were doing 
  199. when the crash occurred, and any error messages (either from the program 
  200. or the Pilot OS) that were displayed during the crash. Please note that 
  201. Star Pilot is not legally responsible for any crash that occurs on your 
  202. Pilot. We recommend you back up your Pilot before using Star Pilot and 
  203. use at your own risk.
  204.  
  205. Q. Why do I have to install so many files, and what does each do? 
  206. A. Most Pilot programs do not rely on a large external dataset. However, 
  207. Star Pilot is not afforded this luxury because there are frankly a lot of 
  208. stars in the sky. We chose to have a single database to minimize the 
  209. number of files, but this still leaves three files to install (for a more 
  210. detailed explination of Star Pilot Plus see spp.txt)
  211. sp.prc - Main program application
  212. splib.prc - Program library, contains additional needed code
  213. spdb101.pdb - Star Pilot database
  214. spregdb.pdb - Registered star database (registered version of Star Pilot 
  215.                                         only)
  216.  
  217. Q. Why can't I find a certain star? 
  218. A. The star database contains only around 500 of the most commonly 
  219. identified stars. Either the star you're looking for is not in the 
  220. database, or we have made a mistake. If you think you've found an error in 
  221. our star database, please contact us and we will look into it. After all, 
  222. the modular design of the program makes it easy to distribute a new 
  223. database if minor modifications are necessary.
  224.  
  225. Q. Will you ever support a device other than the PalmPilot? 
  226. A. Maybe, if WinCE is as popular in the long run as the Pilot has been, 
  227. it's a possibility that we'll port the application, but no guarantees. 
  228. Microsoft has recently started a program that is designed to give 
  229. developers free tools and tutorials, but we have yet to see any of them.
  230.  
  231. Q. I have a question that's not listed in this FAQ, what should I do? 
  232. A. Feel free to contact us with any other questions or comments at 
  233. sp@star-pilot.com
  234.  
  235.